home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
otour11d.zip
/
ONTOUR.DOC
< prev
next >
Wrap
Text File
|
1992-09-02
|
43KB
|
1,051 lines
ONTOUR - page 1
▄███████▄ ▄██▄ ▄██▄ ▄██████████▄ ▄███████▄ ▄██▄ ▄██▄ ▄████████▄
████▀▀▀████ █████▄ ████ ▀▀▀▀████▀▀▀▀ ████▀▀▀████ ████ ████ ███▀ ▀███
███ ███ ███████████ ████ ███ ███ ████ ████ ███▄ ▄███
███ ███ ████▀██████ ████ ███ ███ ████ ████ █████████▀
████▄▄▄████ ████ ▀████ ████ ████▄▄▄████ ███████████ ████ ▀████▄
▀███████▀ ▀██▀ ▀██▀ ▀██▀ ▀███████▀ ▀███████▀ ▀██▀ ▀██▀
Version 1.10c
───────────────────────────────────────────── ──── ┌┬────.
─════ ││ \
The sysop is not at home! So we must do -═══ ││ ╘──────
the correspondence for him! ──────`│-════ -
HE IS --- ON TOUR! ─═══─ \ ┌
─── `─═════════┴
─────────────────────────────────────────────────
This program and the documentation is copyrighted material.
It is (c) by PBS - Peter Hampf, FIDO 2:240/11 --
all rights reserved.
Original visual interface concept designed by Joaquim H.
Homrighausen. Used with permission.
Ok, let's start now with the discussion about the sense of this
program. But NOTE: writing a documentation is not the finest job,
so please let me make it fast and small ... (reading the docs is
not the finest, too, I think...)
Note: The changes since Version 1.00 are NOT shown. Please read
the WHATSNEW - file.
│ 1. part of the journey.
│ What it is ....
└─────────────────────────────────────────────
You know the problem? You are on vacation and thousands of
netmails are reaching your system with thousands of people in the
background who are sitting in front of their computer and are
awaiting your response :-)
Why not tell them, that you can't answer right now but will do
this later? Nothing easier than this!
That is the moment for ONTOUR coming on the plan ... Please give
this program a try.
ONTOUR will scan your netmail folder for mails addressed to one of
10 definable names. (e.g. YOU and your alien-names) If there is a
mail to one of this names, ONTOUR will generate a response mail
and OPTIONALLY mark the original mail as received AND/OR move it
to another directory. You can define up to 15 specific template-
files (see later in this document) for 15 nodes. All other nodes
will get the standard template (which must be defined, too).
ONTOUR - page 2
│ 2. part of the journey.
│ The Setup
└─────────────────────────────────────────────
The SETUP is quite as easy. A fullscreen-setup program, called
S_ONTOUR is part of the ONTOUR package. Please run this program at
once - and every time you plan a new vacation (because the CRCFile
- see later - must be updated...).
Now fill in all the needed fields. In line 25 you get a little
help. If one line is marked as MANDATORY, you *MUST* fill it out.
Please start with the SYSTEM PARAMETERS:
o if you specify your NAME in the first field, THIS name will be
used as the addressee of your response mail otherwise the
ORIGINAL TO-name will be used! (e.g. one of your 'alien'-
names?!)
o the path to your mailer's netmail ...
o if you specify a move-path here (AND ONLY IF), all ANSWERED mail
will be moved to this path. If any mail is disqualified for
answering (excluded person/text, cosysop ...) it will stay
untouched in your mailer's netmail-path.
There is one exception: if you have set the ONCE-ONLY - flag and
there comes another netmail from one person who had already got
a response, this mail will be moved, too!
o your STANDARD-TEXTFILE. If you receive a netmail from a node not
listed in the node-window, this template will be sent to him.
PLEASE DEFINE ONE, IF YOU DO NOT, A STANDARD (ENGLISH) TEXT WILL
BE SENT OUT!!! An example is included in this package
(EXAMPLE.DTB).
NOTE: you CAN define an own TEARLINE in your template. But only
if you are a registered user, ONTOUR will NOT insert it's own!
If you define a tearline (a line starting with three dashes) and
are not registered, your message will have two tearlines..... .
o your DELAY-TEXTFILE. This textfile has a special meaning: if you
are at home (AT HOME=YES) *AND* you have defined an answer-delay
(see BEHAVIOUR) then this textfile is used for answering the
mails. No special-textfile-matching will be done!!! (You may
leave this entry blank. In that case the standard-textfile will
be used or a special textfile - if the calling node has one!)
o your TEXTFILE-DIRECTORY. ALL (!) defined textfiles have to
reside here!!!
o name of CRCFile. ONTOUR will calculate a CRC32-Checksum of every
answered mail and store this checksum in the file specified
here. THIS IS RECOMMENDED! ONTOUR has the capability to store up
to 1000 CRCs - enough for the most cases.
NOTE: if ONTOUR reaches the 1000st mail, the first 100 CRC will
be deleted. So you can be sure, that at least 900 CRCs are EVER
present! (Like a ring-counter...) If you are back from vacation,
you can (but MUST not do it) create a new CRC-file for your next
journey ;-) (simply enter S_ONTOUR and walk into the field "Name
of CRC-file" -- the rest is automatism :-)) --- In addition
you have the capability to mark all answered mails as received!
ONTOUR - page 3
This is the second secure way to prevent dupes! The third method
automatically used by ONTOUR is the checking of the mails
timestamp. Only new mail will be processed by default. (See
below, parameter /F)
o your mailer's rescan-semaphore file. If specified, this file
will be touched or rewritten every time a new message is
generated. So this message could be send out immediately with
your next automatic poll.
o your mailer's INBOUND. This path is only needed for locating the
REMOTE-MAINTAINANCE-FILE called OTREMOTE. If you want to switch
ONTOUR's behaviour from remote, you have to do the following
steps:
- set up this path
- define a PASSWORD (see below)
- go ON TOUR ;-)
- send a textfile to your own system. This textfile must have
the name "OTREMOTE" without any extension. The first line MUST
contain your password. The other lines may contain the
following (note, that wrong lines simply will be ignored!):
ATHOME=YES/NO (Yes or no;-)
DELAY=xxx (xxx = 0 to 255 days)
ONCEONLY=YES/NO (only one answer to a 'writer'?)
COPYONLY=YES/NO (ONLY copy to cosysop, no answer?)
CRASH=crash/direct/
route/dontanswer (set the behaviour on CRASH-mails!)
COSYSOP=name (New name of COSYSOP to copy to!)
COSYSOPADDRESS=<fidoaddr> (and his FIDO-address)
^^ be aware of this TWO Ds :-))
o LOG-file. Specify a logfile if you want ONTOUR to write which
mails have been answered.
o external EDITOR: if defined, you have the capability to edit
your TEMPLATES from within ONTOUR - SETUP. You can supply any
name, including .BAT - files. A .BAT-file will be executed via
your command-processor (make sure that the COMSPEC environment
variable is set!).
o EMS/XMS swapping: when editing a template, S_ONTOUR will swap
out the most of the memory either to EMS, XMS or to DISK.
Specify YES if you want to use the EMS/XMS method! (If you have
EMS installed!) If set to NO, a swapping file will be generated.
If there is not enough memory, S_ONTOUR will notify you with the
error-number 257!
o REMOTE-PASSWORD: the remote-maintainance is only available, if
you specify a password here! (Ooo, sorry, I forgot: REMOTE-
MAINTAINANCE is a registered-only-feature..., sorry)
Ontour's BEHAVIOUR:
o the LOCAL-mail switch qualifies LOCALLY generated mails for
processing, too. Note that you can TOGGLE the setting of this
switch by using the /L commandline parameter!
ONTOUR - page 4
o within the next fields you can specify, whether to generate an
INTL-Kludge line in your response-mails. This affects only mails
from your OWN zone! Foreign-zone messages will ever have an
INTL-LINE. (NOTE: the ZONEGATE-handling will be implemented in a
later version, it isn't until now!)
o FOREIGN-ZONES: if set to YES, ALL mails from other zones will be
answered. If you have defined an AKA in the AKA-matching table
(see below) this AKA will be used otherwise your main-address.
Note, that this switch only affects mails from UNLISTED systems
(NOT listet in your AKA-matching-table).
o KILL - tell me, whether to set the kill/sent-flag (let your
mailer delete the message after being sent) or not.
o MARK as received - please specify whether an ANSWERED mail
should be marked as received (tell other programs you have read
it!) or not. This could be useful if you run e.g. TrackM or
another program which will move received mails to another
directory! Another point of view is that ONTOUR will never
answer a received mail! (Unless the /R parameter is used.)
o SKIP KLUDGES - if ONTOUR replys to a netmail and uses one of
your defined TEMPLATES it will by default insert the kludgelines
of the original message into the %MESSAGE% macro. (The format of
the 'quotet' kludgelines is e.g.: @INTL 2:240/3 2:240/11)
Setting this option to YES will prevent ONTOUR from quoting the
kludges. IMPORTANT NOTE: this option affects the calculating of
the message-length! Be aware of this when entering the next two
options:
o Minimal length: if you specify any value here, ONLY mails
greater or equal this value (in bytes) will be processed. Only
the MESSAGETEXT is counted, and (if SKIP KLUDGES is set to NO)
the kludgelines.
o Minimal length of FREQUEST and ATTACH mails: if set to 0, this
option disqualifies filerequest and -attach messages from being
answered. Setting it to any value greater than the first
"Minimal length" option means: answer all normal mails that are
greater or equal than "Minimal length" (bytes) but filerequests
only if they are greater or equal this value! That prevents you
from answering those shitty freq-messages "* Reply to message in
blabla ...." without any important text!!!
o ONCE-ONLY: if you set this switch to "yes" every person will get
only one (!) response-mail regardless how often he writes to
you. The next time you start S_ONTOUR you will be asked whether
to delete the 'ONCE-ONLY-CHECKFILE'. This is the only method to
answer again mails from persons who have already received a
response!
o CRASH-handling: here you can decide how ONTOUR will react on
crashmails! The following mails are treated as crash-mails:
1.) the CRASH - bit is set.
2.) a ^AFLAGS IMM or
3.) a ^AFLAGS DIR kludge line is present
If you decide to ROUTE your automatic answer, the %MESSAGE%
macro will be disabled and one standard-line will be inserted
insteed. Why that? It's simple: if somebody sends you your new
key via crashmail and you are quoting the original text via
ONTOUR, the whole net will be informed ;-)
ONTOUR - page 5
Alternatively you can send your answer CRASH (crash-bit set) or
DIRECT (^AFLAGS DIR) or simply don't answer crash-mails!
Many thanks to Carsten Schroeder (2:240/520) for this very
important hint!
o ANSWER-DELAY: if you enter a number greater then 0, ONTOUR will
wait these number of DAYS before answering a new netmail!
(Thanks to Reinier de Groot for this suggestion!). This is done
by comparing the *.MSG - timestamp against the actual time AND
against the ONTOUR.DTI - timestamp. Leapyears are considered!
BUT NOTE: this ANSWER-DELAY is only used, if you are at home!
(AT-HOME-SWITCH set to YES) If you are NOT at home, mails will
be answered immediatly.
The actual time and date MUST match <Filedate + DELAY> (or
higher) *AND* the ONTOUR.DTI timestamp MUST match [NOT higher
than <Filedate + Delay>]. (If the ONTOUR.DTI-timestamp is higher
than <Filedate + Delay>, then this message must have been
already processed!)
If you use a tool that touches your netmail-messages again and
again, these mail would never been answered. (But don't worry, I
don't know such a tool ;-) ANSWER-DELAY and all time-checking
will be disabled by using the command-line-switch "/F".
o SYSOP IS AT HOME :-) --- this is the 'main-switch' of ONTOUR. If
set to YES *AND* ANSWER-DELAY is set to 0, no incoming netmail
will be answered! If you use this switch, there is no need to
alter your batchfile! Just set it to NO if you go on vacations.
(Take care of the combination AT HOME <> ANSWER-DELAY!)
o SWITCH-DATE: you can define a date to switch the AT HOME setting
of ONTOUR! Example: you set AT HOME to NO, define an ANSWER-
DELAY of 2 and set SWITCH-DATE to 30.08.1992. You go on tour
from 20.08.1992 to 02.09.1992. From 20.08-30.08 ALL mails will
be answered immedialty! From 01.-02.09 the mails will be
answered with a 2-days-delay, so you have the chance to answer
them manually if you are back in time! (If you will come back
later, e.g. on 05.09., the mails will be answered by ONTOUR!)
If you define a date, it will be shown in different colors:
dates in the past are shown in darkgray (error!), the color will
change at day-number 30, 60 and 90 from today!
ONTOUR - page 6
Now let's go to the NOTIFY - section:
o just before you go ON TOUR, it could be a good idea to notify
closed friends, your uplinks or your points! You can do this
here by defining (and creating) a notify-textfile, defining your
AKA to use and just pressing ENTER on the 'NOTIFY NOW' - line.
Please create a textfile (you can do this by pressing F10
*after* defining the filename) in the standard-textfiles-
directory. This file *MUST* contain 4 lines per node. Between
this 4 line there may be *NO* empty line! One node-entry can be
seperated from the next by inserting one or more lines startung
with a ";". (See example in NOTIFY.ARJ)
1. line: the name of the node to notify
2. line: his/her FIDO-adress and *optinally* one or more
of this flags:
CRASH -> make a crash-mail
IMM -> send it out IMMEDIATELY
K/S -> kill after sending
HOLD -> put it on hold
example: 2:240/21 crash imm k/s
NOTE: if you have "KILL MSGS" in the
Bit-settings menu set to yes, the new message
will be killed after sending even if you don't
write K/S!
3. line: the SUBJECT-LINE of the new message
4. line: the textfile to send to this node (*NOTE*: you
can specify a FULL pathname. If you specify only
a filename, the standard-textfiles directory is
assumed!)
This textfile may contain the following MACROS:
%FIRSTNAME% -> the first name of the node
%FULLNAME% -> the node's full name (as
specified in line 1)
I think, two macros should be enough for notification reasons.
Next switch to the ADDRESS-SCREEN:
o first give me your MAIN-Address. This address is used to write
your response mails!
When you are a registered user of ONTOUR, you can enter up to 9
AKAs (10 addresses, 1 main + 9 AKAs). THIS IS NOT A RESTRICTION!
IT IS AN ADDITIONAL BONUS FOR REGISTERED USERS!!!
o AKA-MATCHING --- this is a registered-only feature. You can
insert up to 20 ZONE:NET - combinations (including
wildcarding!!) and a matching AKA for every entry. If a netmail
from one defined ZONE:NET arrives, it will be answered with your
corresponding AKA. NOTE: the "FOREIGN ZONES" switch in the
systems-parameter menu will NOT affect this mails. That means
that incoming mail from one system defined here will ever be
answered correctly. If you set FOREIGN-ZONES to NO only mails
from UNLISTED foreign systems will NOT be answered.
ONTOUR - page 7
o the CO-SYSOP screen is very important. If (and only if) you
specify a name for your CO-SYSOP (may be your own name!!!), ANY
answered mail will be forwarded to him/her using the specified
address! The mail will be sent using your AKA or, if you type a
"*" in the AKA-line, using the ORIGINAL writers name and
address.
The next line is also VERY important! If you set COPY-ONLY to
yes, NEVER - under no circumstances - any mail will be answered.
The incoming mail will only be forwarded to your cosysop! (So he
can do the job for you ;-)
NOTE, that your COSYSOP can write as many mails to you as he
wants to! He will NEVER get a reply from ONTOUR. Carsten
Schroeder (2:240/20) requestet this and I think it was a usefull
hint.
Next switch to the NAMES-SCREEN:
- please fill in your name(s). NOTE, that ONTOUR will only scan
for mails addressed to one of this names, *NOT* for your name
specified in SYSTEM-PARAMETERS! THE FIRST NAME IS YOUR *REAL*
REGISTRATION - NAME! This *must* be the same as you sent me with
your registration-form! Take this in mind!
F10 toggles the checking-method from strong (Names must exactly
match!) to relaxed (name can be anywhere within the TO-line of
the message)! This is new since version 1.10a! e.g. if you
insert "Peter" as your name and choose RELAXED, ALL MAILS TO ALL
PETERS WOULD BE ANSWERED!!!
--->>> NOT THE NAME YOU'VE ENTERED IN THE "SYSTEMS-PARAMETER"
MENU IS THE REGISTRATION NAME BUT THE FIRST NAME IN THE "NAMES-
SCREEN" !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
- Some points asked me for this and I have added the capability to
answer *EVERY* incoming mail regardless of the name. This is
*ONLY* usefull for points. They will normally receive only mail
to their own! To activate this function, place a "*" as name in
one of the lines.
WARNING: DO NOT USE THIS FUNCTION IF YOU ARE A NODE !!!!!! ;-)
The SPECIAL-TEXTFILES-SCREEN:
- here you can define up to 15 specific response templates and up
to 3 nodes for each template. Just press ENTER, fill in the
filename (without path), and insert the nodes you want to get
this file instead of the standard-file (defined in SYSTEM-
PARAMETERS). That's all. BUT DON'T FORGET TO GENERATE THE
FILES :-)
# please don't worry, but in the unergistered-mode you can only
define ONE extra template with ONE extra address. Registering
ONTOUR will bring up all of the additional, powerfull features.
Take in mind that ONTOUR is NOT crippled! This features are
mentioned as a BONUS for you, if you take the time to register
with me.
The very powerful matching - algorithm allows you to select a
wide range of combinations. e.g. you can make 2:240/21.2 get
another filename than 2:240/500.3, 2:240/500.0 (the chef:-)
ONTOUR - page 8
should get the same as 2:512/149 and all other 2:240/xx - node a
third one. To do so, just define 4 templates.
Combine 2:240/500.2 with template 1, 2_240/500.3 with template
2, 2:240/500 and 2:512/149 with template 3 and 2:240/*.* with
template 4. As you see, the combination of NODE=* AND POINT=*
will make all nodes and points of this ZONE:NET that are NOT
defined elsewhere get this template (if there is no matching in
any way, the standard template will be sent, if this doesn't
exist a hard-coded text).
Within this screen there are 2 additional keys available:
- pressing T will bring up a window, answering you for a
nodenumber to test. You can enter a valid nodenumber an
ONTOUR-SETUP will show you the matching file for this node. So
you can easily verfiy your settings!
- pressing F will scan for all defined files and mark the
existing ones with an √ - sign.
BUT NOTE: this feature will be disabled, if you set AT HOME to
YES *AND* have defined an ANSWER-DELAY *AND* have defined a
DELAY-TEXTFILE!
The EXCLUDE-SCREEN:
- are there any nodes who should NOT get a response mail? No
matter - define them here! It's a good idea to define some so
called ROBOTNAMES, too. e.g. AREAFIX or D'BRIDGE. You can give
me up to 15 names.
SPECIAL NOTE: every NAME is CaSeINSenSiTIve! In every case! And
also PARTIAL names will match! If you define "AL" as name,
"ALBERT" will match as well as "CARSTEN BALDER"!
T A K E C A R E O F T H I S !!!
Another "NOTE": there are a few text-strings predefined
(hardcoded) so you don't have to take care about them. At
present this are:
- GECHO (for Gerard van der Land's famous
echomail-processor!)
- AREAFIX (you know what this is :-)
- AREALINK
- ARCMAIL (if you TOSS before ONTOUR this entry
would be redundant, but who knows ... .)
- D'BRIDGE (the second available mailer :-))
- IMAIL
- FMAIL
- RAID
- JAMESMGR THE famous file-echo-manager ;-)
If there is any other file- or echo-robot replying to you, you
can exclude it by specifying it's name (or a part of it!) here.
The EXCLUDE-TEXT-SCREEN:
- These entrys are treated in a special way. If one of these texts
EXACTLY appears anywhere in the TEXT-BODY of the original
ONTOUR - page 9
message, these message won't be answered in any way. NOTE that
these texts ARE case-sensitive! You can enter the most control-
codes as well. Example: "^APID: ghost" (press CONTROL-A for ^A)
will NEVER answer ANY mail containing the kludge line from the
GHOSTWRITER <tm> in it. As well you can enter "File missing" as
text and ONTOUR will never answer FrontDoor's <tm> 'failed'-
messages. If the first char of a line is '@', it will be
translated to #1 (the first char of any kludgeline). This makes
it a little bit easier to enter kludges.
- one entry must not be defined seperatly but is used hardcoded by
default: "^APID: ONTOUR" :-) That meens that you must not take
care about, that two ONTOURs will reply each other ping-pong :-)
in the case that both sysops are on vacation and one of them
wrote a 'last-minute-letter'.
MSBSCAN-Parameters:
- Please read the extra DOC included in this package. One note: if
you define a *.MSG - path here, ONTOUR will look there for mails
to answer, too! This way you can use this path even if you not
use MSBSCAN itself (and have two different netmail-directories
for ONTOUR).
QUIT!
- yeah, what could that be ;-) Just quit the setup-program and
store any made changes (you can decide not to store, when
answering the question with 'N'.)
NOTE: You can leave every menu with the ESC - KEY. The ADDRESS-
fields anywhere in the program can be DELETED with the DEL key!
BUT BE AWARE: NO QUESTION IS ASKED! Pressing F1 from
the mainmenu will bring up some VERY little information about the
beta-team ... :-)
REGISTRATION:
o Yeah! Great! Your decison is wise! Please enter your
registration code here, this enables the AKA-matching-system and
all of the very powerfull templates!
ONTOUR - page 10
--- There is a little bonus for FrontDoor<tm> users. If you start
the setup program S_ONTOUR the first time, it will ask you whether
to import some (SOME!) settings from the FrontDoor-setup. You can
import at EVERY time later by typing "S_ONTOUR IMPORT"! For this
you MUST have defined the environment variable FD= (you should
have some if you are using FD :-)) NOTE, that ALL your AKAs are
imported but in the unregistered mode only the MAIN-AKA will be
used!
│ 3. part of the journey.
│ The RUN
└─────────────────────────────────────────────
To run the MAIN-program, simply call it! That's all. All needed
information will be catched from ONTOUR.PBS, the setup file
generated by S_ONTOUR.EXE. Normally you should insert the call
into your MAIL-IMPORT - batchfile BEFORE calling any other program
that could move your netmail away :-)
But there are a few <optional> parameters:
- /? -- show this parameters :-)
- /M -- force MONOCHROME - mode (also valid for S_ONTOUR)
- /R -- normally ONTOUR will *NOT* answer already RECEIVED
mails. With this parameter you can override this logic and
received mails will be answered, too.
- /C -- answer EVERY matching mail even if there is already a
calculated CRC-checksum for it.
- /L -- TOGGLE the setting of the LOCAL-mail switch! If you have
enabled LOCAL mail, /L will disqualify them and vise versa.
- /F -- this switch will force a complete scan of your netmail
directory. Normally ONTOUR will ONLY recognise mails that have
received AFTER the last ONTOUR - RUN. NOTE: ONTOUR
will create a file called ONTOUR.DTI every time you run it. This
semaphore-file will be placed in ONTOUR's HOMEDIRECTORY. Please
do NOT delete it, unless you want a complete rescan.
You can enter the parameters with a SLASH or with a minus-sign!
ONTOUR will exit with various ERRORLEVELs that allow you e.g. to
call your NETMAIL-packer...
ONTOUR - page 11
ERRORLEVEL meaning
-----------------------------------------------------------------
0 OK -- NO response message generated
3 Urps! Control-file not found, use S_ONTOUR
4 The control-file is INVALID, use S_ONTOUR
5 The (existing) CRC-file is damaged (should never
occur)
6 Very strange error writing the CRC-file (should
never occur)
7 Not enough memory on HEAP! UPS --> can only
occur if you have a 128KB - machine :-) or are
using ONTOUR in a level-8-shell :-)
100 OK - response message GENERATED --> you can
decide to call e.g. GECHO PACK
│ 4. part of the journey.
│ The TEMPLATES
└─────────────────────────────────────────────
TEMPLATES are the plain ascii files to send. You can write what
you want to. In the current release of ONTOUR you can use the
following MACROS:
macro meaning/replacement
-----------------------------------------------------------------
%FIRSTNAME% the first name of the person who wrote the mail
%LASTNAME% the same person's lastname
%DATE% the current date in the format: "13 Jun 92"
%TIME% the current time in the format: "22:41:12"
%SYSOP% the name you have defined as YOUR NAME in the
SYSTEM-PARAMETER-SCREEN! If this name is not
defined, the original TO-name will be used.
%TONAME% the TO-name of the original message. If you have
defined some aliases (in the NAMES-SCREEN) and
there comes a message to one of your aliases,
%TONAME% will be filled with your alias-name.
%MESSAGExxx% insert the original message itself in the new
message! If you specify xxx (a decimal number),
then only the first xxx lines will be inserted.
e.g.: %MESSAGE20% -> insert 20 lines of the
original message! If you have enabled the 'kludge-
quoting' (default), the kludgelines are counted,
too. For the whole message insert %MESSAGE%
NOTE: ALL OTHER TEXT IN THE LINE CONTAINING THIS
MACRO WILL BE IGNORED!!!! AT NO CASE MORE THAN
32000 BYTES WILL BE EXPORTED!!!!
ONTOUR - page 12
If the original message has paragraphs without the
NEWLINE-mark (#13), one line will be assumed to
have 80 characters. This may result in having one
additional line in your quote (because the
reader's editor may wrap the lines).
%MESSLEN% this macro returns the physical length of the
original message. If you have set SKIP KLUDGES to
NO, they will also be counted!
%MESSDATE% returns the date/time of the original message.
%SYSTEM% the callings system ADDRESS in the format 2:240/11
Further you can insert ANY valid environment variable into your
templates. This is a VERY POWERFUL AND FLEXIBLE method of making
one template for many vacations! For example you write a line like
this:
I am ON TOUR in %%place%, and will be back soon!
Now you must define the environment variable PLACE by typing (from
the DOS PROMPT AND NOT FROM WITHIN A SHELL!!!): SET PLACE=Munich
The above line will now be replaced by:
I am ON TOUR in Munich, and will be back soon!
You can use EVERY environment variable, e.g. %%COMSPEC%, too :-)
You only have to take care, that the macro is preceeded by TWO
%-signs! NOTE: if the variable does NOT exist, ONTOUR will replace
your macro with (???).
You have the ability to insert a TEARLINE in your template! If one
line is starting with three dashes ("---"), no standard-tearline
will be generated. (Of course, the PID-Kludge is EVER
inserted....) NOTE: if you register ONTOUR the definition of an
own tearline will result in skipping ONTOUR's own one....
ONTOUR - page 13
│ 5. part of the journey.
│ Address - logic
└─────────────────────────────────────────────
Allow me some words about how ONTOUR will find out the address of
the original mail. If there is a ^aMSGID-Kludge, the address will
be taken from here. If not, ONTOUR will look for an ^aINTL-Kludge
and tries to get it from there. If this second method fails, the
address will be taken from the message-bits - BUT ONLY THE NET AND
THE NODE-NUMBER! In that case the response mail will be sent to
your own MAIN-ZONE! The POINT-Information is grabbed from the
^aFMPT-Kludge only and will be inserted into the response mail as
a ^aTOPT-Kludge. (If you are a point yourself, a ^aFMPT-Kludge
will be inserted in the response mail, too.)
The method choosen will be reported in the logfile by inserting an
[MSGID], [INTL ] or [BITS ] - tag in it.
│ 6. part of the journey.
│ Legal stuff
└─────────────────────────────────────────────
As you know, I will guarantee NOTHING. You use this program at
your own risk. I've tried to make this program as save as possible
-- but who knows?! If you detect any error, please report it!
Here's my FIDO-address again:
GRANNY's INN , 2:240/11 BBS-number: 49-4441-5404, online 24h
Last, but not least:
THIS PROGRAM IS SHAREWARE! IT IS *NOT* FREE!
I've made many programs, declared as POSTWARE (people have only to
send a postcard!). The resonance was NOT satisfactory! Many
persons are using my SITEINFO (a utility for FrontDoor, the HIGH
RELIABLE MAILER) but only 12 have sent a card until today :-(
So I've decided to take a VERY little amount of money for this
program. ONTOUR can be VERY useful for you, so it is not too much
to pay 15 DM (Deutsche Mark) for it!
If possible, please pay in german currency. If you have no
possibility to get some D-Mark, calculate the corresponding amount
in your own currency and pay it ;-)
There are two ways for payment:
- send your money direct to: (preferred)
Peter Hampf
Graf von Galen Strasse 27
D-2848 Vechta
Germany
ONTOUR - page 14
- transfer it to my bank:
Volksbank Vechta e.G.
BLZ (Bankleitzahl) 280 641 79
Kto.-Nr. (Kontonummer) 126 758 200
Together with your payment send me the REGISTRATION-FORM (via
electronic mail or via slow post). That's all! I will thank you
VERY VERY much for registering and can go on developing programs
for you!
│ 7. part of the journey.
│ Support and registration sites
└─────────────────────────────────────────────
Dutch people can register this package with Hans Siemons
(2:512/149) from PRIME productions. (If you don't know him, have a
look on his products!) Please contact:
Hans Siemons,
Crogtdijk 1,
4815 AD, Breda
Nederland.
A dutch registration from (ONTOUR.RNL) is included in this
package. Have a look on it for further information.
The german support and registration site is Eckhart von dem Berge
(2:240/500 and 2:240/501)
Eckhart von dem Berge
Meissenstraße 81
3300 Braunschweig
Germany
You can obtain the latest version of ONTOUR by file-requesting the
MAGIC name "ONTOUR" at their addresses (and mine, of cource :-)
Regards,
Peter
P.S.: I know that there are many orthographical errors in this
document. Please don't read them :-)
=== SMALL INDEX ===
^APID .............................9
ADDRESS - LOGIC ..................13
ADDRESS-SCREEN ....................6
AKA-MATCHING ......................6
ANSWER-DELAY ................2, 5, 8
AT HOME ........................5, 8
ATTACH ............................4
BEHAVIOUR .........................3
BITS .............................13
CO-SYSOP ..........................7
CRASH-HANDLING ....................4
CRC32-CHECKSUM ....................2
DELAY-TEXTFILE .................2, 8
EDITOR ............................3
EMS/XMS SWAPPING ..................3
ERRORLEVEL .......................11
EXCLUDE-SCREEN ....................8
EXCLUDE-TEXT ......................9
F1 ................................9
FOREIGN-ZONES .....................4
FREQUEST ..........................4
IMPORT ...........................10
INBOUND ...........................3
INTL .............................13
INTL-KLUDGE .......................4
KILL ..............................4
LEGAL STUFF ......................13
LOCAL-MAIL ........................3
LOG-FILE ..........................3
MARK ..............................4
MINIMAL LENGTH ....................4
MSBSCAN-PARAMETERS ................9
MSGID ............................13
NAMES-SCREEN ......................7
NOTIFY ............................6
ONCE-ONLY .........................4
PASSWORD ..........................3
PAYMENT ..........................13
QUIT! .............................9
REGISTRATION ......................9
REMOTE-MAINTAINANCE ...............3
OTREMOTE ......................3
REMOTE-PASSWORD ...................3
RESCAN-SEMAPHORE ..................3
ROBOTNAMES ........................8
SKIP KLUDGES ......................4
SPECIAL-TEXTFILES-SCREEN ..........7
STANDARD-TEXTFILE .................2
SUPPORT AND REGISTRATION .........14
SWITCH-DATE .......................5
SYSTEM PARAMETERS .................2
TEMPLATES ........................11
MACRO ........................11
TEXTFILE-DIRECTORY ................2
THE RUN ..........................10